home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3c / mq_setattr.z / mq_setattr
Encoding:
Text File  |  1998-10-20  |  4.2 KB  |  67 lines
  1.  
  2.  
  3.  
  4. mmmmqqqq____sssseeeettttaaaattttttttrrrr((((3333cccc))))                                                  mmmmqqqq____sssseeeettttaaaattttttttrrrr((((3333cccc))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_qqqq______ssss_eeee_tttt_aaaa_tttt_tttt_rrrr - set attributes of a message queue
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_mmmm_qqqq_uuuu_eeee_uuuu_eeee_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _mmmm_qqqq______ssss_eeee_tttt_aaaa_tttt_tttt_rrrr _((((_mmmm_qqqq_dddd______tttt _m_q_d_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt _mmmm_qqqq______aaaa_tttt_tttt_rrrr _****_m_q_s_t_a_t_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt _mmmm_qqqq______aaaa_tttt_tttt_rrrr
  15.      _****_o_m_q_s_t_a_t_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _mmmm_qqqq______ssss_eeee_tttt_aaaa_tttt_tttt_rrrr sets the attributes, specified in the _m_q__a_t_t_r structure
  19.      pointed to by _m_q_s_t_a_t, of the message queue described by _m_q_d.  The
  20.      attributes of the queue specified by the following fields of the _m_q__a_t_t_r
  21.      structure are updated after a successful call to _mmmm_qqqq______ssss_eeee_tttt_aaaa_tttt_tttt_rrrr:
  22.  
  23.      _mmmm_qqqq______ffff_llll_aaaa_gggg_ssss  If the OOOO____NNNNOOOONNNNBBBBLLLLOOOOCCCCKKKK flag is set, then the _mmmm_qqqq______ssss_eeee_nnnn_dddd and _mmmm_qqqq______rrrr_eeee_cccc_eeee_iiii_vvvv_eeee
  24.                functions do not block when operating on the _m_q_d queue
  25.                descriptor.  Other queue descriptors referring to the same
  26.                message queue are not affected.
  27.  
  28.      The values of all the other members of the _m_q__a_t_t_r structure, pointed to
  29.      by _m_q_s_t_a_t are ignored by _mmmm_qqqq______ssss_eeee_tttt_aaaa_tttt_tttt_rrrr.
  30.  
  31.      If _o_m_q_s_t_a_t is non-NULL, the previous message queue attributes are stored
  32.      in the _m_q__a_t_t_r structure pointed to by _o_m_q_s_t_a_t. The attributes stored in
  33.      the _m_q__a_t_t_r structure are the same as those retrieved by _mmmm_qqqq______gggg_eeee_tttt_aaaa_tttt_tttt_rrrr.
  34.  
  35.      _mmmm_qqqq______ssss_eeee_tttt_aaaa_tttt_tttt_rrrr will fail if one or more of the following conditions are true:
  36.  
  37.      [EBADF]        The message queue descriptor, _m_q_d, is not valid.
  38.  
  39.      [EINTR]        A signal interrupted the _mmmm_qqqq______ssss_eeee_tttt_aaaa_tttt_tttt_rrrr function call.
  40.  
  41. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  42.      _mmmm_qqqq______oooo_pppp_eeee_nnnn(3c), _iiii_nnnn_tttt_rrrr_oooo(3c), _mmmm_qqqq______uuuu_nnnn_llll_iiii_nnnn_kkkk(3c), _mmmm_qqqq______rrrr_eeee_cccc_eeee_iiii_vvvv_eeee(3c), _mmmm_qqqq______ssss_eeee_nnnn_dddd(3c),
  43.      _mmmm_qqqq______gggg_eeee_tttt_aaaa_tttt_tttt_rrrr(3c), _mmmm_qqqq______nnnn_oooo_tttt_iiii_ffff_yyyy(3c),
  44.  
  45. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  46.      Upon successful completion, a value of 0 is returned and the attributes
  47.      of the message queue are changed as specified.  Otherwise, a value of -1
  48.      is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.